home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1993 November / JCSM Shareware Collection - 1993-11.iso / cl980 / atmain1j.lzh / AUTOMAIN.DOC next >
Text File  |  1991-12-05  |  15KB  |  352 lines
  1.                         AUTOMOTIVE MAINTENANCE !!!!
  2.  
  3.                                 V1.0
  4.  
  5.  
  6.                              WRITTEN BY:
  7.  
  8.                             DAVE SCHOEFFEL
  9.  
  10.                dRs Engineering
  11.  
  12.  
  13.  
  14. INTRODUCTION
  15.  
  16. I wrote the Automotive Maintenance program because I could never remember
  17. when it was time for my vehicles to be serviced.  I hate having the little
  18. stickers on my car that the service places insist on gluing all over the
  19. place.  So I came up with this neat little Windows program to help remind
  20. you to take good care of your vehicle(s).  You may store up to 1000
  21. maintenance items in each data file.
  22.  
  23. Another neat feature, described later in this document is the REMIND feature.
  24. This feature allows the data files created with the Auto Maintenance program
  25. to be checked at computer start up time or any other time that remind is run.
  26. This is a DOS program that could be placed in your AUTOEXEC.BAT file.  It will
  27. sound a beeper and display which vehicle is due and when.
  28.  
  29. This program was written using Microsoft Visual Basic version 1.0 to run under
  30. Windows 3.0 and must have the VBRUN100.DLL file located in your path. Simply
  31. place VBRUN100.DLL in your Windows directory (or any convenient directory
  32. in your path) and forget about it.  This file is available on most bulletin
  33. boards as well as other sources, and should be obtained and installed prior
  34. to using the Auto Maintenance program.
  35.  
  36. Be sure to check out the other fine products offered by Dave Schoeffel of dRs
  37. Engineering.  These products are available on many bulletin board systems, as
  38. well as Compuserve in the WINADV section.  (Please note that these programs
  39. are all designed for Windows 3.0 and are written using Microsoft Visual Basic.
  40. Therefore, the above mentioned file VBRUN100.DLL is a must.)
  41.  
  42.     Product (file name)    Description
  43.     TODOV1_4.ZIP        To Do List Daily Organizer (Rich in Features.)    
  44.     ABCV1_0.ZIP        Alphabet Teaching for small children.
  45.     123V1_0.ZIP        Number Teaching for small children.
  46.  
  47.  
  48.  
  49. REGISTRATION
  50.  
  51. This program is being released as Shareware.  Please feel free to copy and
  52. distribute it freely amoung your friends and business associates.  I would 
  53. ask, however, that if you find the program useful (the definition of useful
  54. in this case meaning that you still have it installed after your evaluation,
  55. then it must be useful) please send the registration fee of $1 to:
  56.  
  57.   THAT'S RIGHT....JUST ONE MEASLY DOLLAR......IS THAT TOO MUCH TO ASK ?????
  58.  
  59.                              Dave Schoeffel
  60.                  dRs Engineering
  61.                              1313 Riverton Dr.
  62.                              Mukwonago,  WI 53149
  63.  
  64. Your registration will encourage me to create other useful programs.  You
  65. will also rest assured that you have done your good deed for the day.
  66.  
  67. Registration has been made simple for the user.  Simply run the program and
  68. choose the ABOUT - ABOUT AUTO MAINTENANCE option from the menu.  This
  69. information screen has a registration form on it and can be filled in by the
  70. user and printed out to be mailed in.  Please take a few short minutes to
  71. register your copy.
  72.  
  73.  
  74. FILES
  75.  
  76. The following files should have been included in the ZIP file that you
  77. received (or all files included from whatever your source for this program):
  78.  
  79.        AUTOMAIN.DOC      This file that you are reading.
  80.        AUTOMAIN.EXE      The executable code for the Auto Maintenance program.
  81.        SAMPLE.AUT        A sample Auto Maintenance File.
  82.        REMIND.EXE     DOS reminder program, documented later.
  83.  
  84.  
  85. INSTALLATION
  86.  
  87. To install the program, simply copy all of the files listed above into a
  88. subdirectory.  Remember that you need the VBRUN100.DLL file somewhere in your
  89. path to use the Auto Maintenance program.
  90.  
  91.  
  92.  
  93. RUNNING
  94.  
  95. You may run the Automotive Maintenance program several different ways.  You
  96. could open File Manager and double click on the AUTOMAIN.EXE file name. It
  97. could also be installed via Program Manager into any convenient group.
  98. Another method of running the Automotive Maintenance program is to install it
  99. into your WIN.INI file.  This will assure that whenever Windows is started,
  100. the Automotive Maintenance program will automatically load.
  101.  
  102. To do this, simply edit your WIN.INI file with a text editor or from within
  103. Windows using the SYSEDIT.EXE function.  In the WIN.INI file locate the line
  104. that says LOAD= and insert (Drive):(Path)\AUTOMAIN.EXE.  This will load the
  105. Automotive Maintenance program every time that Windows is run.  You may also
  106. wish to run the REMIND.EXE program every time you start Windows.  In order to
  107. do this, please reference the discussion of the REMIND program later in this
  108. document.
  109.  
  110.  
  111.  
  112. OPERATION
  113.  
  114. Operating the Automotive Maintenance program is simple.  Using the mouse, 
  115. place the cursor in the VEHICLE DESCRIPTION box and type a description of the
  116. vehicle that you wish to keep track of.  Then simply click on the UPDATE/ADD
  117. command button to begin entering information.
  118.  
  119. ****IMPORTANT NOTE:****
  120.     This program sorts information by the date field.  In order to use
  121.     the feature NEXT DUE DATE, described below, be sure to use an 8 digit
  122.     date code when entering the date.  You could use either mm/dd/yy or
  123.     mm-dd-yy, but do not mix the two formats.  Doing so will fool the way
  124.     the program sorts the data that you enter and will give unpredictable
  125.     results.
  126.  
  127. When this information has been entered, you choose FILE - SAVE AS to store
  128. this vehicle information to your disk.  You may then print this information or
  129. use several of the advanced features of the program described elsewhere in
  130. this document.  As more information is entered and the list grows, the user
  131. will see a scroll bar that is used to scroll up and down in the data file 
  132. beyond the limits of data that is displayed on the screen.
  133.  
  134. The following section of this document describes all of the features and how
  135. to use them.
  136.  
  137.  
  138.  
  139. FILE - NEW
  140.  
  141. The FILE - NEW option of the menu simply starts a new work space to enter
  142. information for a new vehicle, one that does not already exist on your disk.
  143. The vehicle description and service information fields are all cleared and
  144. the service interval variable is set to 0.
  145.  
  146.  
  147.  
  148. FILE - OPEN
  149.  
  150. The FILE - OPEN option of the menu gives the user the capability to load in
  151. a maintenance file that had previously been created and stored to disk.  The
  152. user is presented with a menu of file choices.  If no files are listed, then
  153. no files have been created and none are available to open.  A sample auto
  154. maintenance file has been included with this program.
  155.  
  156.  
  157.  
  158. FILE - SAVE
  159.  
  160. The FILE - SAVE option of the menu stores the current contents of all program
  161. parameters (Vehicle Description, all service information and the current
  162. service interval value) to the current filename.  The current filename can be
  163. found on the main menu following the AUTO MAINTENANCE - prompt.  If no
  164. filename has previously been entered, using the FILE - SAVE AS option
  165. described below, the filename will be 'untitled'.  To specify a valid vehicle
  166. filename, see the FILE - SAVE AS option below.
  167.  
  168.  
  169.  
  170. FILE - SAVE AS
  171.  
  172. The FILE - SAVE AS option of the menu stores the current contents of all
  173. program parameters (Vehicle Description, all service information and the
  174. current service interval value) to a valid filename specified by the user.
  175. This filename must follow all standard DOS file naming characteristics, i.e.
  176. an eight digit filename with a three digit extension.  The filename extension
  177. used for Auto Maintenance files is .AUT.  If the user does not enter this
  178. information, the program will automatically append it to the filename.
  179.  
  180.  
  181.  
  182. FILE - PRINT HISTORY
  183.  
  184. When all service information is entered and saved to a disk file, the user
  185. may choose to create a hard copy paper printout of the vehicle service 
  186. history.  The FILE - PRINT HISTORY option of the menu allows the user to 
  187. print this vehicle service history to the standard Windows printer.
  188.  
  189.  
  190.  
  191. FILE - EXIT
  192.  
  193. The FILE - EXIT option of the menu allows the user to completly exit the
  194. Auto Maintenance program and terminate any further Auto Maintenance recording
  195. activity.
  196.  
  197.  
  198.  
  199. OPTIONS - SERVICE INTERVAL
  200.  
  201. The OPTIONS - SERVICE INTERVAL option of the menu allows the user to enter
  202. a suggested service interval to be used when clicking the NEXT DUE DATE 
  203. command button.  This interval is the number of days to be used when
  204. calculating when routine maintenance is due.  Most new vehicle manufacturers
  205. recommend frequent oil changes at regular mileage or time intervals.  If you
  206. drive a lot of miles, you may want to enter an approximate number of days that
  207. it will take for you to reach the recommended mileage service interval.  If
  208. you drive a small amount of mileage, enter the number of days corresponding
  209. to the manufacturers recommended time between service intervals.
  210.  
  211. This number is stored together with all of the other service information for
  212. the vehicle you are entering in the vehicle file.  It is also used with the
  213. DOS program that you can enter in you AUTOEXEC.BAT file to remind you to
  214. service your vehicles when you first turn on your computer.  This DOS program,
  215. REMIND is described elsewhere in this document.
  216.  
  217.  
  218.  
  219. ABOUT - ABOUT AUTO MAINTENANCE
  220.  
  221. The ABOUT - ABOUT AUTO MAINTENANCE option of the menu gives general
  222. information about the program and the programmer.  This is also the option
  223. that should be used to register your copy of the Automotive Maintenance
  224. program.  Simply choose ABOUT - ABOUT AUTO MAINTENANCE from the menu, fill in
  225. the registration form, print it out, and mail it complete with the
  226. registration fee to the programmer listed.
  227.  
  228.  
  229. ADD/UPDATE COMMAND BUTTON
  230.  
  231. Clicking the ADD/UPDATE command button brings up a dialog box that allows the
  232. user to enter vehicle service information.  The information entered is Date,
  233. Mileage, and Maintenance.  This information is stored with the vehicle
  234. description and the service interval variable in the data file.
  235.  
  236.  
  237.  
  238. DELETE ITEM COMMAND BUTTON
  239.  
  240. In order to delete certain information from the Auto Maintenance form, simply
  241. highlight the item to be deleted and click the DELETE ITEM command button. In
  242. order to assure that the item has been deleted, be sure to save the file
  243. before exiting the program or loading a different data file.
  244.  
  245.  
  246.  
  247. NEXT DUE DATE COMMAND BUTTON
  248.  
  249. Pressing the NEXT DUE DATE command button will bring up a dialog box that
  250. shows when your next recommended vehicle service should be performed.  Please
  251. refer to the OPTIONS - SERVICE INTERVAL description above for a dialog of the
  252. use of this program option and it's implications.  This option is as a
  253. reminder only and should not be relied upon as the only means for assuring
  254. good vehicle routine maintenance.
  255.  
  256.  
  257. ******    REMIND.EXE  *****
  258.  
  259. The REMIND program is a simple DOS program that can be used to check your
  260. .AUT files that were created using the Auto Maintenance program.  A very
  261. simple and effective use for this program would be to place the commands in
  262. you AUTOEXEC.BAT file and allow the program to remind you of vehicle
  263. maintenance requirements at regular intervals.  This program uses the data 
  264. files and service interval information entered previously.  The last date of
  265. vehicle service is checked and and compared using the service interval and
  266. current date to determine whether to remind you to have your vehicle serviced.
  267.  
  268. The correct syntax for using the program is as follows:
  269.  
  270.     (Drive):(Path)\REMIND (Drive):(Path)\name.AUT days
  271.  
  272. where "name" is replaced with the name of the .AUT file that you wish to be
  273. checked and days is the number of days ahead of time that you wish to be
  274. notified.  The number of days ahead can be up to 30 days.  If you do not
  275. specify a number, 0 days is used and you will not be notified of maintenance
  276. due until the actual day that it is due.
  277.  
  278. NOTE:    If you enter more than just routine maintenance into your vehicle
  279.     service database, then the service reminder could happen multiple 
  280.     times between regular service intervals.  This could be avoided by
  281.     creating separate routine maintenance and major service data files.
  282.     You would then simply use the remind program on just the routine
  283.     maintenance file.
  284.  
  285. The user is presented with a reminder at program run time to have their 
  286. vehicle serviced.  This message will come up when the vehicle is within the
  287. number of days ahead specified within the required maintenance interval.  The
  288. message will continue to appear whenever REMIND is run (in your AUTOEXEC.BAT
  289. file as well) until the new service information is entered into the database
  290. using the Auto Maintenance program described above.
  291.  
  292. This message will stay on the screen for 30 seconds or until the user presses
  293. any key on the keyboard.  This will allow the computer to continue to boot, if
  294. you have placed REMIND in your AUTOEXEC.BAT file after 30 seconds has expired.
  295.  
  296. In order to have this program run every time that you start Windows, create
  297. a batch file that contains the commands that you wish to execute.  For example
  298. you could create a batch file called REMINDER.BAT.  The commands in this .BAT
  299. file could be as follows:
  300.         REMIND ACCORD.AUT 5
  301.         REMIND CIVIC.AUT 10
  302.  
  303. Then, you could place this file in you WIN.INI file under the RUN= section.
  304. Simply add the text (Drive):(Path)\REMINDER.BAT after the RUN= statement in
  305. your WIN.INI file.  This will assure that you are reminded of vehicle
  306. maintenance every time that you start Windows.  (Plese note that you could
  307. use this same type of batch file in your AUTOEXEC.BAT file as well).
  308.  
  309.  
  310.  
  311. VERSION INFORMATION
  312.  
  313. AUTO MAINTENANCE
  314. Version 1.0    Initial Release.
  315. 10-31-91
  316.  
  317. REMIND
  318. Version 1.0    Initial Release
  319. 10-31-91
  320.  
  321. Version 1.01    Boy these computers are dumb.  The worst part about that is
  322. 11-01-91    the fact that the programmers of these dumb computers must be
  323.         even worse.  That's right, this program worked fine on 10/31,
  324.         but I got to 11/01, and you guessed it, the program stopped
  325.         working.  To make a long story short, 11/01/91 is greater than
  326.         11/ 9/91.  Note the difference in the date formats.  Now the
  327.         program is fixed so that 11/01/91 is really less than
  328.         11/09/91.  Oh well, if we learn from our mistakes, I should
  329.         be getting real smart any day now.........
  330.  
  331. Version 1.02    O.K., so I didn't get it right, even the second time.  This
  332. 11-19-91    program has a real hard time doing date math.  The standard
  333.         method of displaying dates is in the mm/dd/yy format.  When
  334.         using this format, however, the values of the date format in
  335.         the program is evaluated as a string.  Therefore, 11/19/91 is
  336.         greater than 01/13/92, because the months and days is checked
  337.         even before the years.  I have now fixed the program to check
  338.         the years first, then the months, then then days.  I hope that
  339.         I have now solved this issue permanently.
  340.  
  341.  
  342.  
  343. -----------------------------------------------------------------------------
  344. Auto Maintenance is a copyright product of David A. Schoeffel and dRs
  345. Engineering of Mukwonago, WI.  Visual Basic version 1.0, Windows 3.0 and
  346. VBRUN100.DLL are all trade marked and copyrighted products of the Microsoft
  347. Corp. of Redmond, Washington.  No warranties, expressed or implied, are
  348. extended for the use of this product or any side effects of the use or misuse
  349. of this product.
  350.  
  351.  
  352.